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This Technical Note discusses how to switch between the two graphics modes, 320 and 640 
horizontal resolution, while running an application which uses the Window, Control, and Menu 
Managers. 

Changes since May 1990: Added information about reinstalling fonts after restarting 
QuickDraw II. 



Why Change Resolution? 

Why not? There are certain applications where the ability to run in both modes is essential; most 
graphics applications fall into this category. Other applications might switch modes to provide 
features which their competitors lack; a financial application might display figures in 640 mode 
and charts in 320 mode. Still other applications may want to give the user the choice. A word 
processor might seem useful only in 640 mode, but what if the user wants to print greeting cards 
with pictures? The user does not need the line length provided in 640 mode but does need the 
added color of 320 mode for the pictures. 

Let me preach a little. I have worked on other machines with different graphic modes and 
learned some things that might be of use to application programmers. Many application 
programmers fight mode switching with either rhetoric or apathy, then when users expect their 
software to run in either mode, they become frustrated when it does not allow switching. To 
avoid the problem of frustrating the user, you can provide mode switching (which is not as hard 
as you might think). 



How To Change Modes 

First, assume you are in an application which is running with a system menu bar, a few visible 
windows with scroll bars, and one window with some standard controls. At some point, the user 
decides to change modes, possibly via a menu item thoughtfully provided by the application 
programmer. Your change mode handler might look like the following: 
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; This step is necessary if QuickDraw Auxiliary is started 

_QDAuxShutDown ;Shut down QDAux first 



QDShutdown 



see 

advertisement 

640. 

mode. 
7 

QuickDraw, 
printing 



Ida 
eor 

sta 



pel 

pei 
pei 



<mode 
#$0080 

<mode 



<QDzpage 

<mode 
<QDwidth 



pei <MyID 
_QDStartup 

_GrafOf f 

; This step is necessary if you 

_QDAuxStartUp 



;Shut down QuickDraw. 

;This will turn graphics off so you will 
;the text screen for a second (a 
; might go here) . 

;Variable that holds current resolution. 
;Flip the mode bit, $0000 = 320, $0080 = 

;New value will be used to start the new 



;Pass the direct pages allocated for 
; New mode . 

;0 for screen width; other numbers for 
;Pass my ID number. 

; Restart QuickDraw in the new mode. 

;Turn screen off because changing mode 
;may not be pretty, 
need QuickDraw Auxiliary 



; Start QDAux again 



; Fix up the cursor for the new mode 



store 



pea 
Ida 
ldx 
beq 
Ida 
pha 
pea 
pea 
_ClampMouse 





#319 
<mode 
store 
#639 



199 



HomeMouse 



ShowCursor 



;Pass minimum cursor X position. 
;Maximum X position for 320 mode. 
;320 or 640 mode? 

;Maximum X position for 640 mode. 

;Pass maximum cursor X position. 

;Pass minimum Y cursor position. 

;Pass maximum Y cursor position. 

; Clamp the cursor to the new screen size. 

;Move the cursor to 0,0 to make sure 
;it is on screen. 
;Make cursor visible. 



; Tell tools about the change 



WindNewRes 
MenuNewRes 
CtlNewRes 



;Tell Window Manager about the change. 
;Tell Menu Manager about the change. 
;Tell Control Manager about the change. 



Fix the screen to look good 



Here you might want to change the color of the desktop, windows, menus 
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controls to look good for the new mode. 



See example below. 



Redraw the screen in the new mode 



pea 
pea 
_Ref reshDesktop 



;Pass flag to draw entire screen. 



;Draw entire screen. 



Graf On 



;Now show the new screen. 



That is not too bad, but I left out the fun part. Before the Ref reshDesktop there is a section 
named "Fix up the screen to look good." This section is where you might want to put some color 
into windows, controls, and menus if you are switching to 320 mode; changing colors is not 
required, but there are some things which are. 

When switching from 640 mode to 320 mode, some windows (both visible and invisible) might 
be positioned off the screen in 320 mode. The first way to handle this problem is easy for you, 
the programmer, but not so great for the user: close all the windows before changing modes, 
then position them correctly when the user opens them in the new mode. The second way to 
handle the problem is to walk the window list and move all the windows, maybe even change 
their sizes. You could double each window's horizontal starting position and width when 
switching from 320 mode to 640 mode and halve it when changing from 640 mode to 320 mode. 
The vertical position and height are okay. An example of the second method is given below. 

Windows with vertical scroll bars in the window frame are the same width when you change 
modes, so switching from 320 mode to 640 mode results in a narrower bar while changing from 
640 mode to 320 mode produces a wider bar. The bars change to the correct size as soon as the 
user resizes the window, since SizeWindow deletes the old scroll bars and allocates new ones 
according to the current mode. If, as suggested above, you resize all the windows after the mode 
change and before calling Ref reshDesktop, you should be in good shape. If you choose not 
the follow this recommendation, you should call SizeWindow for every window with scroll 
bars and change the size of each window at least one pixel since SizeWindow does not do 
anything if the passed size is not different than the current size. 

You should dispose of scroll bars in a window's content region and recreate them; this is not 
nice, but very few applications have scroll bars in a window's content region. 

You should not resize any open new desk accessory (NDA) windows. NDAs may be dependent 
on screen mode, or their current position, or other such things which may change with resolution. 
To be kind to the NDAs, you should issue a CloseAllNDAs call. This call allows the NDAs 
to go through their normal close procedures. If a user wants an NDA open in the new screen 
resolution he must reopen it. This assures that the NDA always knows its own position and the 
current screen resolution. 

WindNewRes resets the desktop shape and pattern and the Window Manager's icon font to their 
defaults for the new mode, so if you changed any of these, you must add to or subtract from the 
desktop again and reinitialize to your custom pattern or icon font again. 
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CtlNewRes resets the Control Manager's icon font to the default for the new mode, so if you 
changed the Control Manager's icon font, you must reinitialize to your icon font again. 

Reinstalling Large Fonts 

After restarting QuickDraw II, you should call InstallFont again on the fonts your 
application is using. This causes the Font Manager to call Inf lateTextBuf f er so that 
QuickDraw can draw text correctly in large font sizes. 

Repositioning and Resizing Windows in the New Mode 

Here is an example of how to reposition and resize windows in the new mode. 
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mode. 



BoundsRect 
document . 
PortRect 



QuickDraw and the tools have already been reinitialized in the new 
mode = $0000 if in 320 mode, $0080 if in 640 mode. 



assumes 
the 



position, 
storel 



mode. 



store2 



enter 



equ 
equ 



16 



_CloseAllNDAs 

pha 

pha 

_FrontWindow 
bra enter 



ldy #BoundsRect+2 

Ida [window] ,y 

eor #$FFFF 

inc a 

asl a 

ldx <mode 

bne storel 

lsr a 

lsr a 



pha 

ldy #BoundsRect 

Ida [window] ,y 

eor #$FFFF 

inc a 
pha 

pei <window+2 

pei <window 
MoveWindow 



ldy 
Ida 
asl 

ldx 
bne 
lsr 
lsr 
pha 
ldy 
Ida 
pha 
pei 
pei 



#PortRect+6 
[window] ,y 
a 

<mode 

store2 

a 

a 

#PortRect+4 
[window] ,y 

<window+2 
<window 



_SizeWindow 

pha 
pha 

pei <window+2 
pei <window 
GetNextWindow 



pla 
sta 
pla 
sta 



<window 
<window+2 



; Offsets in port record from QuickDraw 



; close all open NDA windows 
; Space for result. 

; Start with the top most window, this 

; there are no invisible windows ahead of 

; active window in the window list. 

;Get window's starting horizontal position. 
; Convert to screen coordinate (negate it). 

; Double it if we're going to 64 mode. 
;Going to 320 or 640 mode? 
; Ready if we're going to 640. 
; Otherwise, undo the doubling, 
;and halve the starting horizontal 

Pass window's new X starting position. 

Get window's starting vertical position. 
Convert to screen coordinate. 

Pass window's current Y starting position. 
Pass window to move. 

Move the window to its new position. 

Get window's current width. 

(This assumes the window's origin is 0,0.) 

Double the window's width if going to 640 

Going to 320 or 640 mode? 
Ready if we're going to 640. 
Otherwise, undo the doubling, 
and halve the window's width. 
Pass window's new width. 

Get window's height. 

Pass window's current height. 

Pass window to resize. 

Resize the window. 

Space for result. 

Pass pointer to window we just processed. 
Get the pointer to the next window. 
Remember the pointer to this window. 



ora 
bne 



<window 
loop 



;Are there any more windows? 
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WindNewRes 

Generally, WindNewRes does the following: 

• closes its port 

• opens its port again, now in the new mode 

• reinitializes the desktop size 

• chooses the proper icon font for close and zoom boxes 

• reinitializes the desktop pattern 

• changes the SCB byte of each window's port to the new mode 

• recomputes the VisRgn for each window 

MenuNewRes 

Generally, MenuNewRes does the following: 

• closes its port 

• opens its port again, now in the new mode 

• reinitializes internal parameters, like vertical line width, for the new mode 

• reinitializes the color palette via InitPalette 

• subtracts the system menu bar from the desktop (this is why you must call WindNewRes 
first) 

• draws the system menu bar 
CtlNewRes 

Generally, CtlNewRes does the following: 

• chooses the proper icon font for radio button, check box, grow box and scroll bar arrows 

• reinitializes internal parameters, like vertical line width, for the new mode 

Further Reference 

• Apple IlGS Toolbox Reference 



Apple IlGS 

#4: Changing Graphics Modes in Mid-Application 



7 of 5 



